home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / fdwcwm22.zip / FE2WC.DOC < prev    next >
Text File  |  1994-12-30  |  11KB  |  327 lines
  1.            FE2WC or FE2WCT v1.01 - Frontend to Wildcat translator utility
  2.  
  3.                     Copyright (C) 1994 by Lawrence Gordon
  4.                               All Rights Reserved
  5.  
  6.  
  7.  
  8. Note: If you are running your Wildcat! v4.x under OS/2, please use FE2WCT.EXE
  9.       because this program is already hard-coded with the /T switch command
  10.       parameter required for running Wildcat! v4.x under OS/2 multitasker.
  11.       Other installation instructions for FE2WC.EXE is the same for FE2WCT.EXE.
  12.  
  13.  
  14.  
  15. 1.  Introduction
  16.  
  17. During the course of the last year, I have written and released numerous
  18. "translators" for FrontDoor, InterMail and Wildcat. The number of these
  19. utilities have grown to the point where I now have trouble keeping track of
  20. which program works with which frontend and which version of Wildcat.
  21.  
  22. Thus, I have written what I hope to be is the last of my translation
  23. utilities for Wildcat, FE2WC or FE2WCT.  This program will work with any
  24. version of FrontDoor and InterMail and either Wildcat v3.x or Wildcat v4.x.
  25.  
  26. Quite simply, the purpose of FE2WC or FE2WCT is to translate the information
  27. found in your frontend's DOBBS.BAT drop file into Wildcat's commandline 
  28. format.
  29.  
  30. Because of the different flavors of FrontDoor and InterMail and versions
  31. of Wildcat, each configuration will be discussed.
  32.  
  33. 2.  Wildcat v3.x and v4.x
  34.  
  35. Wildcat v3.x and v4.x basically operate on the same commandline
  36. parameters when called from a frontend:
  37.  
  38. WILDCAT /B 14400MNP 560
  39. |       |  |    |   |
  40. |       |  |    |   Time until frontend's next hard event
  41. |       |  |    Error correction flag (must be MNP)
  42. |       |  Connect speed
  43. |       Switch used with frontend
  44. Program name
  45.  
  46. However, when using Wildcat with a frontend, the difference between 
  47. versions is significant.
  48.  
  49. Wildcat v4.x can support any connect speed passed to the bbs by the
  50. frontend.  Legal connect speeds are user-defined in Wildcat v4.x
  51. by using the Makewild program.
  52.  
  53. On the other hand, Wildcat v3.x's legal connect speeds are hardcoded
  54. into the program, and in order to pass a connect speed that is not
  55. supported by Wildcat, such as 12000 or 28800, a workaround is necessary.
  56.  
  57. 3.  FrontDoor 2.02/nc and InterMail v2.1x
  58.  
  59. The DOBBS.BAT produced by FrontDoor v2.02/nc and versions of InterMail
  60. prior to versions 2.2 looks something like this:
  61.  
  62. EXEBBS 14400 2 560 /ARQ
  63. |      |     | |   |
  64. |      |     | |   Error correction string
  65. |      |     | Time until next hard event
  66. |      |     Comport
  67. |      Connect speed
  68. Program to run BBS
  69.  
  70. 4.  InterMail v2.2x
  71.  
  72. The DOBBS.BAT produced by InterMail v2.2x looks something like this:
  73.  
  74. EXEBBS 14400 2 560 /Arq 1
  75. |      |     | |   |    |
  76. |      |     | |   |    Mailer ID number
  77. |      |     | |   Error correction string
  78. |      |     | Time until next hard event
  79. |      |     Comport
  80. |      Connect speed
  81. Program to run BBS
  82.  
  83. Note: For FE2WC.EXE or FE2WCT.EXE to work correctly with InterMail, all  
  84. possible connect speeds should be set to Y(es) for Error Correction, even 
  85. if certain connects do not support error correction.
  86.  
  87. 5.  FrontDoor 2.1x/Shareware
  88.  
  89. The DOBBS.BAT produced by FrontDoor v2.1x/Shareware looks something 
  90. like this:
  91.  
  92. EXEBBS 14400 2 560 0 /ARQ N/A
  93. |      |     | |   | |    |
  94. |      |     | |   | |    Caller ID
  95. |      |     | |   | Error correction string
  96. |      |     | |   Task number (always 0)
  97. |      |     | Time until next hard event
  98. |      |     Comport
  99. |      Connect speed
  100. Program to run BBS
  101.  
  102. 6.  FrontDoor 2.2x/ml
  103.  
  104. The DOBBSx.BAT produced by FrontDoor v2.2x/ml looks something like
  105. this:
  106.  
  107. EXEBBS 14400 2 560 1 /ARQ N/A
  108. |      |     | |   | |    |
  109. |      |     | |   | |    Caller ID
  110. |      |     | |   | Error correction string
  111. |      |     | |   Task number (defined by environmental variable)
  112. |      |     | Time until next hard event
  113. |      |     Comport
  114. |      Connect speed
  115. Program to run BBS
  116.  
  117. Note that FrontDoor v2.2x/ml produces a DOBBSx.BAT file, where x is
  118. the environment variable set in your frontend's batch file:
  119.  
  120. SET TASK=1 will produce a Task number 1 when FrontDoor 2.2x drops to
  121. call DOBBS1.BAT.
  122.  
  123. SET TASK=2 will produce a Task number 2 when FrontDoor 2.2x drops to
  124. call DOBBS2.BAT.
  125.  
  126. 7.  Using FE2WC or FE2WCT in your EXEBBS.BAT
  127.  
  128. FE2WC.EXE or FE2WCT.EXE may be placed in any directory in your path, but it 
  129. must be run from an EXEBBS.BAT in your mailer's home directory because that
  130. is where it looks for the DOBBS.BAT file produced by your frontend.
  131.  
  132. With any version of FrontDoor, the home directory is usually D:\FD, where 
  133. D is the drive letter of your system. 
  134.  
  135. With a single-line version of InterMail, the home directory is usually 
  136. D:\IM, where D is the drive letter of your system. With a multiline
  137. version of IM, the home directory is the home directory of each mailer
  138. id number, each requiring a separate EXEBBS.BAT file.
  139.  
  140. FE2WC.EXE or FE2WCT.EXE takes 3 commandline arguments (4 if used with 
  141. FrontDoor v2.2x/ml).
  142.  
  143. For example an EXEBBS.BAT used with InterMail v2.2x and Wildcat v3.x
  144. might look like this:
  145.  
  146. REM Start of EXEBBS.BAT
  147. @ECHO OFF
  148. FE2WC C:\WC30 IM 3
  149. C:
  150. CD\WC30
  151. CALL DOWC.BAT
  152. C:
  153. CD\IM
  154. REM End of EXEBBS.BAT
  155.  
  156. You'll notice that EXEBBS.BAT runs FE2WC with three commandline
  157. parameters:
  158.  
  159. FE2WC C:\WC30 IM 3
  160.       %1      %2 %3
  161.  
  162. %1 = Wildcat's home directory
  163. %2 = Mailer type
  164. %3 = Wildcat version number
  165.  
  166.    %1: Wildcat's home directory is simply the directory where WILDCAT.EXE 
  167.        is located.  Do not use a trailing backslash "\" after the drive and 
  168.        directory name.
  169.  
  170.    %2: Mailer type is the frontend in use. Valid mailer types are as 
  171.        follows:
  172.  
  173.        IM    - InterMail v2.2x
  174.        FDNC  - FrontDoor v2.02/nc and InterMail v2.1x
  175.        FDSW  - FrontDoor v2.11/Shareware
  176.        FDML  - FrontDoor v2.2x/ml
  177.  
  178.    %3: Wildcat version number:
  179.  
  180.        3 - Wildcat v3.x
  181.        4 - Wildcat v4.x
  182.  
  183. If you are using FrontDoor v2.2x/ml, a fourth parameter is necessary:
  184.  
  185. FE2WC C:\WC30 FDML 3 %TASK%
  186.                      |
  187.                      replaceable environmental parameter for the
  188.                      task number defined in FrontDoor v2.2x/ml's
  189.                      batch file
  190.  
  191.  
  192. For example an EXEBBS.BAT used with FrontDoor v2.2x/ml and Wildcat v3.x
  193. might look like this:
  194.  
  195. REM Start of EXEBBS.BAT
  196. @ECHO OFF
  197. FE2WC C:\WC30 FDML 3 %TASK%
  198. C:
  199. CD\WC30
  200. CALL DOWC%task%.BAT
  201. C:
  202. CD\IM
  203. REM End of EXEBBS.BAT
  204.  
  205.  
  206. 8.  Line by Line Explanation of EXEBBS.BAT
  207.  
  208. This EXEBBS.BAT assumes you are using InterMail v2.2x and Wildcat v3.x.
  209. It also assumes that your frontend is set to drop a DOBBS.BAT with
  210. an errorlevel of 225 on a bbs call like so:
  211.  
  212. :loop
  213. IM
  214. IF Errorlevel 225 goto bbs_call
  215. IF Errorlevel 10 goto bye
  216.  
  217. :bbs_call
  218. CALL DOBBS.BAT
  219. goto loop
  220.  
  221. :bye
  222. exit
  223.  
  224. REM Start of EXEBBS.BAT
  225. 1: @ECHO OFF            
  226. 2: FE2WC C:\WC30 IM 3   
  227. 3: C:
  228. 4: CD\WC30
  229. 5: CALL DOWC.BAT
  230. 6: C:
  231. 7: CD\IM
  232. REM End of EXEBBS.BAT
  233.  
  234. Note: the above line numbers are for reference only and should not appear
  235. in your actual EXEBBS.BAT file.
  236.  
  237. 1: Turn echoing to the screen off
  238. 2: Run FE2WC telling it that (%1) Wildcat's home directory is located
  239.    in C:\WC30; (%2) that InterMail v2.2x is your mailer; and (%3) that
  240.    you are running Wildcat v3.x.
  241. 3: Change drive to Wildcat's home drive.
  242. 4: Change directory to Wildcat's home directory.
  243. 5: CALL DOWC.BAT - this file is created by FE2WC. Be sure to use
  244.    CALL so that control of the program flow will be returned to
  245.    EXEBBS.BAT after DOWC.BAT runs Wildcat.
  246. 6: Change drive back to InterMail's home drive.
  247. 7: Change directory back to InterMail's home directory.
  248.  
  249. Since EXEBBS.BAT ends and was CALLed by the frontend's batch file,
  250. control of the program flow is now returned to bbs_call: in your
  251. batch file, which loops back to restart your frontend.
  252.  
  253. 9.  DOWC.BAT
  254.  
  255. The batch file created by FE2WC.EXE or FE2WCT.EXE is called DOWC.BAT,
  256. and it's written to your Wildcat home directory.  It simply runs Wildcat
  257. with the correct commandline parameters. In the above example,
  258. using InterMail v2.2x and Wildcat v3.x, the DOWC.BAT file will look 
  259. something like this:
  260.  
  261. @ECHO OFF
  262. WILDCAT /B 14400MNP 560
  263. REM  ===================================== 
  264. REM   This file was created by FE2WC v1.0  
  265. REM    Copyright 1994 by Lawrence Gordon   
  266. REM  ===================================== 
  267.  
  268. A new DOWC.BAT will be written each time your frontend drops a DOBBS.BAT
  269. file on a bbs call, creating the correct commandline for that bbs call.
  270.  
  271. 10. Wildcat v3.x and "oddball" connects
  272.  
  273. As explained above, Wildcat v3.x has certain "hardcoded" connect speeds
  274. and rejects calls where the actual connect speed differs from one of the
  275. hardcoded connect speeds.  Without a means to translate a CONNECT 16800,
  276. for instance, Wildcat will reject a call at that speed, because 16800
  277. is not one of the hardcoded connect speeds.
  278.  
  279. FE2WC provides a "workaround" for this problem.  Suppose your frontend
  280. receives a bbs call with a connect speed of 16800.  FE2WC will "fudge"
  281. the connect speed to allow Wildcat to see the connect speed as 19200, 
  282. which is one of Wildcat v3.x hardcoded connect speeds.
  283.  
  284. For example, say your frontend drops the following DOBBS.BAT:
  285.  
  286. EXEBBS 16800 2 560 /Arq 1
  287.  
  288. After running FE2WC through your EXEBBS.BAT file, your DOWC.BAT
  289. will call Wildcat like so and Wildcat will "think" it has a valid
  290. 19200 connect:
  291.  
  292. @ECHO OFF
  293. WILDCAT /B 19200MNP 560
  294. REM  ===================================== 
  295. REM   This file was created by FE2WC v1.0  
  296. REM    Copyright 1994 by Lawrence Gordon   
  297. REM  ===================================== 
  298.  
  299. 11. Files In This Archive
  300.  
  301. FE2WC.DOC       This document
  302. FE2WC.EXE       The program
  303. FE2WCT.EXE      The program for people running under OS/2 with /T appended
  304. EXEBBS.FDN      Sample EXEBBS.BAT for FrontDoor v2.02/nc
  305. EXEBBS.FDS      Sample EXEBBS.BAT for FrontDoor v2.1x/Shareware
  306. EXEBBS.FDM      Sample EXEBBS.BAT for FrontDoor v2.2x/ml
  307. EXEBBS.IM       Sample EXEBBS.BAT for InterMail v2.2x
  308. DESC.SDI        One line bbs description
  309. FILE_ID.DIZ     Detailed bbs description
  310.  
  311. 12. Freeware
  312.  
  313.  
  314. Note: If you are running your Wildcat! v4.x under OS/2, please use FE2WCT.EXE
  315.       because this program already have the required /T command switch 
  316.       parameter required by Wildcat! v4.x hard-coded in it.
  317.       You can ONLY use FE2WCT.EXE with Wildcat! v4.x because ONLY Wildcat v4.x
  318.       required this /T command switch.
  319.  
  320. There is no charge for using this program; however, FE2WC or FE2WCT is not
  321. public domain. I retain the copyright.
  322.  
  323. Lawrence Gordon, Author
  324. Toast House BBS
  325. (314) 994-0312
  326. Fidonet 1:100/560
  327.